home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / both350.arc / BOTH350.DOC < prev    next >
Encoding:
Text File  |  1989-08-15  |  11.1 KB  |  340 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                BOTH.EXE
  12.  
  13.                              Release 3.50
  14.  
  15.                             August 14, 1989
  16.  
  17.             -----------------------------------------------
  18.                 Copyright (c) 1989 by Peter F. Feldmann
  19.                           All Rights Reserved
  20.            Limited permission is granted to individual users
  21.            for private, non-commercial use and transmission
  22.               to other individuals, provided these files
  23.                        are unaltered in any way.
  24.  
  25.                All other rights are explicitly reserved
  26.                             by the author.
  27.             -----------------------------------------------
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  BOTH prints ASCII text files to both sides of the page in "book" or
  34.  "magazine" style.  BOTH does this by scanning the specified input
  35.  file, then helps the user make decisions on specific page formats,
  36.  etc.  The file is printed as alternate pages (eg. odd side first, 1,
  37.  3, 5, 7, . . .).  Once one side has been completed, reverse the paper
  38.  and re-insert it into the printer to print the other side (eg. 2, 4,
  39.  6, . . .).
  40.  
  41.  Limited text formatting commands are included, but the user must as-
  42.  sume responsibility to preset the printer with the correct formatting
  43.  controls (ie., choice of font or type style, number of lines per
  44.  page, characters per line, etc. etc.)
  45.  
  46.  USAGE:
  47.  
  48.          BOTH  [[[D:]pathname\]filename.ext]  <ENTER>
  49.  
  50.      If no filename is specified, BOTH prompts the user for a file
  51.  to be printed.  Wildcard file specifiers cannot be used directly,
  52.  though a GROUP.BAT file which uses BOTH to print a group of specified
  53.  files is included on the BOTH350 distribution diskette*.
  54.  
  55.  ---------------------------------------------------------
  56.  * - sent to all registered users.
  57.  
  58.  
  59.  BOTH 3.50           Documentation           Page 2/7
  60.  
  61.  
  62.  Once a file is specified, BOTH scans the entire file, searching for
  63.  the widest line, the number of lines in the file, and checking for
  64.  the presence of form feed characters in the text.  The text file's
  65.  "statistics" are displayed near the top of the screen for reference.
  66.  
  67.  
  68.                          FILE   CONFIGURATION
  69.  
  70.  The following procedure helps BOTH determine the necessary informa-
  71.  tion to print text files correctly to BOTH sides of a page.  Default
  72.  settings are shown in CAPS inside the brackets [].
  73.  
  74.  "Prepare to Print File [Y/n] ?"
  75.  -------------------------------
  76.  If "N" is entered, BOTH discards the current file and prompts the
  77.  user for another filename for possible printing.
  78.  
  79.  
  80.  "Print [60] lines/page ?"
  81.  -------------------------
  82.  If BOTH finds no form feeds in the file, the first question in the
  83.  configuration menu asks how many lines of text per page are to be
  84.  printed (60 is the default value).   If the file has been pre-
  85.  formatted with blank lines (so that there are 66 lines/page on a
  86.  standard sheet), be sure to specify the exact number of lines which
  87.  totally fill one page (at 6 lines/inch, a sheet 11 inches long would
  88.  be filled with 66 lines), and answer NO to the "AutoFormat" prompt
  89.  below.
  90.  
  91.  LASER-JET USER'S NOTE: When using a Laser-Jet(tm) type printer, be
  92.  sure that the printer's number of lines per page menu setting is at
  93.  least three lines more than the total page length specified to BOTH.
  94.  Check that the Laserjet's menu has been set to lock in the desired
  95.  typeface.
  96.  
  97.  
  98.  "Begin at page [1]?"
  99.  --------------------
  100.  Specify the beginning page number to print.
  101.  
  102.  
  103.  "End at page [nn]?"
  104.  -------------------
  105.  BOTH automatically calculates the number of pages it will take to
  106.  print the complete file at the number of lines per page rate you
  107.  specified.  To end at an earlier page, just type in its number.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  BOTH 3.50           Documentation           Page 3/7
  115.  
  116.  
  117.  "Print Odd or Even pages first? [O/e]"
  118.  --------------------------------------
  119.  "O" will print the odd pages of the file (ie., 1, 3, 5, . . .  etc.)
  120.  
  121.  
  122.  "Pause after each page? [y/N]"
  123.  ------------------------------
  124.  If "Y" is chosen, BOTH will pause after sending each page to the
  125.  printer.   The user may either continue or halt the print operation.
  126.  This feature is useful if you're using a single sheet printer or just
  127.  experimenting with the format of a page.
  128.  
  129.  
  130.  "AutoFormat pages? [Y/n]"
  131.  -------------------------
  132.  BOTH has limited capabilities to lay out "raw" text files (eg.,
  133.  source code) into reasonably formatted pages.  The "AutoFormat" fea-
  134.  ture subtracts two lines from each page: the first is used as a blank
  135.  line, the second contains the filename, date, and page number of the
  136.  file being printed.  Because two lines are effectively removed from
  137.  each page to implement this feature, the "AutoF" number given at the
  138.  top of the screen may be a little larger than that given for pre-
  139.  formatted text files.  NOTE: BOTH also adds an extra three spaces on
  140.  the left margin of odd numbered pages for binding purposes.  Even
  141.  numbered pages are unaffected.
  142.  
  143.  
  144.  "Add line numbers to listing? [y/N]"
  145.  ------------------------------------
  146.  A simple line numbering feature in the format: "nnnn>" (adding five
  147.  characters to the width of each text line) is available here for
  148.  those interested in printing source code, etc.
  149.  
  150.  
  151.  "Is printer limited to 80 columns? [y/N]"
  152.  -----------------------------------------
  153.  If you answer "Y" (yes) to this prompt, BOTH will automatically trun-
  154.  cate text lines longer than 80 characters.  This is done to avoid in-
  155.  serting extra "wrapped" lines while the text is being printed.  NOTE:
  156.  BOTH will NOT add the three extra spaces on odd-numbered pages for
  157.  binding space if this option is enabled.  Also, if you use line num-
  158.  bering (see above), BOTH will DEDUCT this space (5 spaces) from the
  159.  maximum 80 character text line to be printed.  Generally speaking, it
  160.  is better not to use this feature unless it is absolutely necessary.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  BOTH 3.50           Documentation           Page 4/7
  170.  
  171.  
  172.  "Send output to LPTx ???? [1]"                    (NEW: BOTH350.EXE)
  173.  ------------------------------
  174.  BOTH needs to know which printer port (LPT1, LPT2, or LPT3) to use
  175.  for its output.  Type in the number 1, 2, or 3 to specify the port.
  176.  If [ENTER] is pressed, BOTH will default to LPT1.
  177.  
  178.  
  179.  "Specify Left Margin Space [0]"
  180.  -------------------------------
  181.  BOTH can generate a left margin space of "n" characters if you so
  182.  desire.  These spaces are in addition to the three spaces reserved
  183.  for binding purposes as explained above.  Type in the number of
  184.  characters you wish added.
  185.  
  186.  
  187.  "Print other side ... ? [y/N]"
  188.  ------------------------
  189.  Once one side has been printed, BOTH prompts the user, asking if the
  190.  other side of the current file is to be processed.  If the user types
  191.  a "Y", the second side will be sent to the printer, keeping all user-
  192.  supplied parameters exactly the same as for the first side printed
  193.  (ie., the same page size, beginning page, ending page, left margin,
  194.  etc.).  To change any parameters, type "N" to this prompt, which will
  195.  bring up the following query:
  196.  
  197.  
  198.  "More Files to Print ?  [a/y/N]"                 (NEW: BOTH350.EXE)
  199.  -------------------------------
  200.  If the user types "A" (Again), the same file will be readied for
  201.  printing, but the user is prompted for new starting and ending pages,
  202.  etc.  If "Y" is entered, the user will be prompted for a new
  203.  filename, otherwise BOTH will exit to DOS.
  204.  
  205.  
  206.  Miscellaneous Notes:
  207.  ---------------------
  208.  BOTH is intended for use with "pure ASCII" text files, such as source
  209.  code and many documentation files (eg., ".DOC" or ".TXT") such as the
  210.  one you are now reading.  While typical word processors embed an as-
  211.  sortment of formatting characters into their files, many can be made
  212.  to produce ASCII text files by "printing to disk".  Unless originally
  213.  written using the non-document mode,  WordStar(tm) files will need to
  214.  be filtered of higher ASCII characters before being printed.  There
  215.  are many such filter programs (such as WS2ASC.COM) available in the
  216.  public domain.
  217.  
  218.  Another possibility is offered by the utility PRNDSK.COM, found on
  219.  the BOTH350 distribution disk.  It offers an easy way to redirect
  220.  printer output to a disk file, which itself can later be sent to a
  221.  printer, edited, etc.
  222.  
  223.  
  224.  BOTH 3.50           Documentation           Page 5/7
  225.  
  226.  
  227.  
  228.  Text files which have been specially treated to double-print lines by
  229.  omitting line feed characters (such as the documentation for some
  230.  versions of PROCOMM), or by including embedded printer control
  231.  characters, may have to be hand-edited before using BOTH.  Files with
  232.  embedded form feeds will usually print acceptably using BOTH "as-is".
  233.  If problems are encountered, try removing the offending characters
  234.  before printing the file.  Any line with an embedded form feed will
  235.  be processed to place the form feed at the end of that line, thus
  236.  keeping all characters in that line on the same page.
  237.  
  238.  ---------------------------------------------------------------------
  239.  
  240.  
  241.  
  242.  BOTH 3.50           Documentation           Page 6/7
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  SPECIAL NOTE:  We'd suggest not attempting to print a 700 page book
  263.  with BOTH before giving it a test file or two (including this .DOC
  264.  file).  Any bug reports would be gratefully received.  Thanks to all
  265.  those who contributed to the success of previous versions of BOTH
  266.  with comments, suggestions and donations, they are much appreciated.
  267.  
  268.  ---------------------------------------------------------------------
  269.  
  270.  
  271.  
  272.  
  273.                              DISTRIBUTION
  274.  
  275.  You are encouraged to share and distribute copies of this program
  276.  free of charge, provided the distribution file (BOTH350.EXE) is kept
  277.  intact, and that the files and documentation are not altered in any
  278.  way.  Users who contribute $20 will be registered and receive the
  279.  next BOTH update free of charge.
  280.  
  281.  Commercial or multi-user licenses and custom versions to print docu-
  282.  mentation files, etc. are available from I.C. Consultants for a
  283.  modest fee.
  284.  
  285.  ---------------------------------------------------------------------
  286.  
  287.  
  288.  
  289.  BOTH 3.50           Documentation           Page 7/7
  290.  
  291.  
  292.  
  293.  
  294.                  ==========  I N V O I C E  ==========
  295.                                     
  296.  
  297.                             IC Consultants
  298.                              P.O. Box 902
  299.                         Santa Barbara, CA 93102
  300.                             (805) 684-0267
  301.                      BIX & MCIMAIL Name: PFELDMANN
  302.              Compuserve ID 75156,2535  **  MCI # 248-9063
  303.                      sdn
  304.  
  305.  Name:
  306.  
  307.  Address:
  308.  
  309.  
  310.  
  311.  I enclose $_______________. Please register me as a user of BOTH350.
  312.  
  313.  __ Bug Report:
  314.  I have encountered a problem using BOTH350.  The equipment I am using
  315.  includes:
  316.  
  317.      Computer:                       BOTH Serial #:
  318.                                         (see bottom of ending screen)
  319.      DOS version:
  320.  
  321.      Printer:            Word Procesor:
  322.  
  323.  Problem description:
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  I enclose a stamped, addressed envelope for your reply. (Registered
  337.  users can contact the author via MCI Mail, CompuServe, or on BIX
  338.  (Byte Information Exchange).
  339.  
  340.        --------------------  EOF  BOTH350.DOC  ------------------